
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>打印高质量日志的10条军规 - 学习卡片</title>
      <style>
        body { font-family: sans-serif; background-color: #f0f8ff; color: #333; display: flex; flex-direction: column; align-items: center; padding: 50px 20px; }
        .header h1 { font-size: 32px; }
        .grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 28px; width: 100%; max-width: 1200px; }
        .card-container { perspective: 1200px; cursor: pointer; height: 250px; }
        .card { width: 100%; height: 100%; position: relative; transform-style: preserve-3d; transition: transform 0.7s; border-radius: 16px; box-shadow: 0 4px 16px rgba(0,0,0,0.08); }
        .card-container.flipped .card { transform: rotateY(180deg); }
        .card-face { position: absolute; width: 100%; height: 100%; backface-visibility: hidden; display: flex; flex-direction: column; box-sizing: border-box; border-radius: 16px; background-color: #fff; padding: 24px; }
        .card-back { background-color: #f0fff4; transform: rotateY(180deg); justify-content: space-between; }
        .card-category { font-size: 14px; color: #0052d9; margin-bottom: 8px; font-weight: 500; }
        .card-question { font-size: 20px; font-weight: 500; flex-grow: 1; display: flex; align-items: center; justify-content: center; text-align: center; }
        .card-answer-wrapper { flex-grow: 1; overflow-y: auto; }
        .card-answer { font-size: 15px; line-height: 1.7; }
        .card-footer { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 16px; margin-top: 16px; }
        .card-source { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 12px; margin-top: 12px; }
      </style>
    </head>
    <body>
      <div class="header">
        <h1>打印高质量日志的10条军规 - 学习卡片</h1>
      </div>
      <div class="grid-container">
        
    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">为什么“多打点日志”这个常见的建议可能是一个危险的陷阱？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">因为没有目的性地大量打印日志，会导致真正有价值的信息被淹没在日志的海洋中，增加排查问题的难度。此外，每一行日志都有其成本，包括存储成本、I/O成本和阅读成本，过多的无效日志（如记录每个方法的进入和退出）本质上是垃圾信息。</div>
          </div>
          <div class="card-source">来源: 一、日志的根本目的与常见误区 - 2. 多打日志是一个危险的建议</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">实践</div>
          <div class="card-question">在捕获异常时，为什么不能机械地在 `catch` 块中统一使用 `log.error`？请举例说明。</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">实践</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">因为很多异常是预期内的业务异常，而非系统级错误。例如，用户输入错误密码导致的 `InvalidCredentialsException` 是一个业务场景，应该用 `log.info` 记录。只有那些意外的、需要人工介入的系统异常（如 `catch (Exception e)` 捕获的未知错误）才应该使用 `log.error` 记录。</div>
          </div>
          <div class="card-source">来源: 二、日志的等级艺术 - 2. 为什么90%的ERROR级别日志都用错了</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">相较于字符串拼接，使用日志占位符（例如 `log.debug("用户: {}, ID: {}", name, id)`）有何性能优势？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">当设置的日志级别高于代码中的日志级别时（例如生产环境设置为INFO，而代码是DEBUG），使用占位符的方式不会执行参数的计算和字符串拼接操作。而字符串拼接（`"用户: " + name`）无论日志最终是否打印，都会先执行拼接，造成不必要的性能开销。</div>
          </div>
          <div class="card-source">来源: 三、日志内容的军规 - 2. 避免日志污染的7个实用技巧</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">根据文档，一条优秀的日志消息应该包含哪些核心要素？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">一条优秀的日志应包含六个核心要素：时间（通常由框架提供）、环境/实例标识、请求标识（如TraceId）、操作主体（谁做了什么）、关键业务参数以及操作结果。</div>
          </div>
          <div class="card-source">来源: 三、日志内容的军规 - 1. 一条好日志的必备要素</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">实践</div>
          <div class="card-question">在日志中处理用户密码、手机号等敏感信息时，应该遵循什么原则？文档推荐了哪些做法？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">实践</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">原则是必须从日志中去除或脱敏处理敏感信息。推荐的做法包括：1. 对敏感字段进行手动屏蔽，例如将密码记录为 `****`；2. 更好的做法是使用专业的日志脱敏工具（如 `LogSensitiveUtils.mask(userInfo)`）来自动化、规范地处理。</div>
          </div>
          <div class="card-source">来源: 三、日志内容的军规 - 3. 敏感信息处理</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">特性</div>
          <div class="card-question">为什么说非结构化日志正在被淘汰？结构化日志（如JSON格式）具备哪些优势？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">特性</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">因为现代系统规模庞大，传统为人类阅读设计的文本日志难以进行自动化处理。结构化日志的优势在于：1. 机器可读，便于自动化分析；2. 字段明确，不会混淆；3. 易于索引和搜索；4. 支持复杂数据结构。</div>
          </div>
          <div class="card-source">来源: 四、结构化日志的威力 - 1. 为什么说非结构化日志正在被淘汰</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">日志操作为何会影响系统性能？异步日志是如何缓解这个问题的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">日志操作是I/O密集型操作，其性能瓶颈主要在于磁盘I/O、字符串处理和多线程同步。异步日志通过将日志写入操作从主业务线程中分离，主线程将日志事件放入内存队列后即可继续执行，由一个独立的后台线程负责将队列中的日志写入磁盘，从而避免了主线程被I/O操作阻塞。</div>
          </div>
          <div class="card-source">来源: 五、日志与性能的选择 - 1. 日志为何会影响性能 & 2. 异步日志的正确实现方式</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">架构</div>
          <div class="card-question">现代系统常用的集中式日志平台（如ELK栈）的基本架构和数据流是怎样的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">架构</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">ELK栈由 Elasticsearch、Logstash 和 Kibana 组成。一个简单的数据流架构是：应用程序的日志由 Filebeat 收集，然后发送给 Logstash 进行解析和处理，处理后的数据存入 Elasticsearch 进行索引，最后通过 Kibana 进行查询、分析和可视化展示。</div>
          </div>
          <div class="card-source">来源: 六、日志的运维与治理 - 2. 集中式日志平台的选择</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">设计基于日志的监控告警时，有哪些常见且有效的设计原则？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">常见的设计原则包括：1. **错误率监控**：监控ERROR级别日志量的突增；2. **关键字监控**：监控特定异常类型或错误码的出现；3. **模式识别**：发现日志输出模式的异常变化；4. **缺失检测**：检测预期的日志是否未出现（例如定时任务未执行的日志）。</div>
          </div>
          <div class="card-source">来源: 六、日志的运维与治理 - 3. 日志监控告警的设计原则</div>
        </div>
      </div>
    </div>

      </div>
    </body>
    </html>
